Thanks Marci! Yep this is what I had in mind. It'd be great to figure out how to autogenerate this doc as new versions are released so we don't have to do it manually, but perhaps we can do that in a future PR.

For now, can you check that it's the same for version 0.87.0 as for 0.87.3 that you added here, and add it to the versioned docs here? For reference, we are only publishing the files from versioned_docs, so any changes in docs/docs wont show up on the published site. What's in docs/docs gets released every night as part of the nightly release process, and will show up in the nightly version tomorrow. https://github.com/AztecProtocol/aztec-packages/tree/mw/bb-cli-docs/barretenberg/docs/versioned_docs/version-v0.87.0

I'm reluctant to hard-code the CLI docs in docs/docs since changes could go unnoticed and it's worse to have wrong CLI docs than no CLI docs, since they can always be retrieved with bb -h.

thanks! I've confirmed that 0.87.0 and 0.87.3 are the same.

I'm reluctant to hard-code the CLI docs in docs/docs

Definitely wasn't trying to do anything like that. 😅 Just still clueless about docs builds, so thanks for the explanation!

I mis-rebased 🫠 so closing this in favor of #17244

@josh ah wait, one clarification: are you saying it should be in docs/docs and versioned-docs? Or only the latter?

Edit: figured it out; please disregard 😁